add mention of gtk_widget_add_events() and GTK_CAN_FOCUS

2002-01-03  Havoc Pennington  <hp@pobox.com>

	* gtk/tmpl/gtkdrawingarea.sgml: add mention of
	gtk_widget_add_events() and GTK_CAN_FOCUS

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index ec94359f972ebef29fa563878a762e9eca2f3cfe..69080fead5e16c3c752e8aed7cbe3d0c426f327b 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2002-01-03  Havoc Pennington  <hp@pobox.com>
+
+       * gtk/tmpl/gtkdrawingarea.sgml: add mention of
+       gtk_widget_add_events() and GTK_CAN_FOCUS
+
 2002-01-04  Matthias Clasen  <matthiasc@poet.de>
 
        * gtk/tmpl/gtktextview.sgml: Small additions.

diff --git a/docs/reference/gtk/tmpl/gtkdrawingarea.sgml b/docs/reference/gtk/tmpl/gtkdrawingarea.sgml
index 7af01b945d4a35b66140c902c2ba850af048ff87..4c6346e06527cca1421fd3fb66434975b58ec3bb 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkdrawingarea.sgml
+++ b/docs/reference/gtk/tmpl/gtkdrawingarea.sgml
@@ -16,7 +16,8 @@ the application may want to connect to:
   <listitem>
     <para>
     Mouse and button press signals to respond to input from
-    the user.
+    the user. (Use gtk_widget_add_events() to enable events 
+    you wish to receive.)
     </para>
   </listitem>
   <listitem>
@@ -79,6 +80,14 @@ gdk_window_invalidate_rect() are equally good ways to do this. You'll
 then get an expose event for the invalid region.
 </para>
 
+<para>
+To receive mouse events on a drawing area, you will need to enable
+them with gtk_widget_add_events(). To receive keyboard events, 
+you will need to set the #GTK_CAN_FOCUS flag on the drawing area, and
+should probably draw some user-visible indication that the drawing
+area is focused. See gtk_paint_focus() for one way to draw focus.
+</para>
+
 <!-- ##### SECTION See_Also ##### -->
 <para>